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Introducing Novell Storage Services 


As your network structure grows, you need larger storage capacity, more 
efficient file management, and faster volume mounting speed. For example, 
you might need large volumes for numerous directories and files, or have 
numerous files open simultaneously. Novell® Storage Services™ (NSS) is a 
64-bit file storage and management system that meets your file system needs. 
It is a seamless, scalable, and flexible storage and file system that lets you 
continually configure, mount, and maintain large volumes and numerous files 
without disrupting the work of end users. 


This book is divided into the following sections: 
For a description of NSS, see Chapter 1, “Overview,” on page 9. 


For setup and configuration information, see Chapter 2, “Setting Up and 
Configuring Novell Storage Services,” on page 19. 


For information about monitoring the status of your storage objects and NSS 
configuration, see Chapter 3, “Viewing Storage Objects,” on page 57. 


For troubleshooting information, see Chapter 4, “Troubleshooting,” on page 
61. 


Documentation Conventions 


In this documentation, a greater-than symbol (>) is used to separate actions 
within a step and items in a cross-reference path. 


Also, a trademark symbol @, TM, etc.) denotes a Novell trademark. An asterisk 
(*) denotes a third-party trademark. 
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Overview 


Novell® Storage Services™ is a storage and file system that provides an 
efficient way to use all of the space on your storage devices. NSS is best used 
with systems that require the ability to store and maintain large volumes and 
numerous files or large databases. 


Novell Storage Services is the default storage and file system for NetWare® 6. 


You use it to create, store, and maintain both traditional and NSS volumes. The 
NSS volumes are called logical volumes. When you install NSS, it creates a 
storage pool SYS: and an equal sized volume SYS:. 


To mount a volume, the traditional file system scans every file and directory. 
Then to provide quick access to the files, NetWare stores all the meta data in 
memory. File system scanning slows the mounting speed. Storing the meta 
data for all files requires more memory as the number of files increase. 


NSS speeds up the mounting process by not scanning the entire file system 
when you mount volumes. The memory requirements are lower because NSS 
does not load Meta data into the memory until you access the files. 


You do not run VREPAIR on NSS volumes when the file system crashes 
because NSS keeps a journal of all file system transactions. After the crash, 
NSS scans the journal to ensure that all transactions are either completed or 
undone. This way volumes do not require any repair when you mount them 
again after the crash. 


NSS uses free space from multiple storage devices. This lets you create 
unlimited volumes and store up to 8 trillion files in a single volume—up to 8 
terabytes in size. NSS also lets you mount up to 255 volumes simultaneously. 


IMPORTANT: In NetWare 5, NSS runs parallel with the traditional NetWare file 
system. In NetWare 6, NSS is the primary storage and management system. 
However, you can continue to maintain traditional partitions and volumes along 
with NSS. Although this documentation focuses primarily on NSS storage pools 
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and logical volumes, it includes instructions for setting up and maintaining 
traditional volumes. 


NSS Features and Benefits 


This section describes the features and benefits of NSS. 


NSS Management 


ConsoleOne™ is the primary utility used to configure and maintain both 
traditional and NSS logical volumes. See “Using ConsoleOne to Configure 
Novell Storage Services” on page 25. 


NOTE: NWCONFIG and NSS Menu are not compatible with some of the NetWare 
6 NSS features. Use ConsoleOne for all NSS configuration and management 
procedures. 


Combine Logical Volumes in a Single Storage Pool 


NSS uses storage pools. A storage pool is a specified amount of space you 
obtain from all your storage devices. Then you place all NSS logical volumes 
into the storage pool. This way you do not have to limit the number of volumes 
you have in a partition. You can have only one storage pool on a partition, but 
you can place unlimited logical volumes in the storage pool. The size of 
logical volumes cannot exceed the size of the storage pool. 


Create Logical Volumes 


The volumes you create from NSS storage pools are called logical volumes. 
A logical volume is a volume that is either set to a specific size, or one that can 
grow dynamically according to the amount of physical space assigned to the 
pool. This lets you add and store any size or any number of files you need 
without having to create other partitions. You can add any number of volumes 
to a storage pool as long as you have available physical space in the pool. 
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Exceed the Limit of Volumes in a Storage Pool (Overbooking) 


Individual logical volumes cannot exceed the size of a storage pool. However, 
you can create numerous volumes in a storage pool. Individual logical 
volumes must be smaller than the storage pool, but the sum of multiple logical 
volumes can exceed the pool size. This feature, called overbooking, can be an 
efficient way to manage your file system. 


For example, you might have a number of users who are individually assigned 
to volumes with a limited amount of space for each volume. You can assign 
volumes that collectively exceed the pool size if not all users fill up their 
volumes. Essentially, the users can borrow space from other volumes in the 
pool as long as there are volumes that are not filled to the limit. This way it is 
not always necessary to add more disk space when some users reach or exceed 
their volume limit. 


Deactivate/Activate Logical Volumes and Storage Pools 


You might need to temporarily prevent user access to storage pools or volumes 
to do maintenance. Instead of bringing down the server, you can deactivate 
individual storage pools to run the REBUILD and VERIFY utilities. When 
you deactivate a storage pool, users will not have access to any of the volumes 
in that pool. The REBUILD and VERIFY utilities generate log files to the root 
of the DOS drive. 


Fast Error Correction and Data Recovery 


NSS quickly recovers data after a file system crash. Instead of scanning an 
entire volume for corruption, NSS quickly replays the latest set of changes to 
make sure they were written correctly. The file system either recovers the 
changed information, or it returns the data to its original settings before the 
transaction began. This is beneficial for applications such as mail services 
because there is less server down time. 


Immediately Save Data to Disk 


The Flush Files Immediately feature saves your file data to disk immediately 
after you close the file instead of waiting for the next flush cycle. This ensures 
that your data is not at risk of being lost between flush cycles. 
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Retain Previously Saved Files (Snapshot) 


The File Snapshot feature allows your backup utility to keep a consistent copy 
of all files. This is done by having the file system keep an original copy of all 
open files. For example, when your system backs up or crashes at a time when 
you are modifying a file, the backup could contain both old and new data. 
Snapshot captures the most recent closed copy of the file. This way, if you lose 
data between the backup cycles, you still have a solid copy of the previously 
saved file. 


Transaction Tracking System (TTS) 


Transaction Tracking System™ protects database applications by backing out 
transactions that are incomplete due to a system failure. TTS™ can be 
available on either all traditional or all NSS logical volumes. It cannot be 
available on all volumes if you use both types of volumes. If your system uses 
both traditional and logical volumes, by default it can only work on traditional 
volumes. If you want to use it on logical volumes on a system that has both, 
you must enter DISABLE TTS on the AUTOEXEC.NCF then enable the 
feature on each logical volume you want it on. Unlike traditional volumes, 
TTS does not apply to logical volumes by default. To enable it on logical 
volumes, enter nss/transaction=volname. 


Review the Modified File List 
The Modified File List is a list of files that changed since the previous backup. 
The backup utility accesses this list instead of searching the entire file system. 
Use Clustering Feature 


Some storage devices exist in a storage area network (SAN). These devices 
can be shared by multiple servers in a cluster. For more information about 
clustering, see Novell Cluster Services Overview and Installation. 


Enable File Compression 


NSS supports file compression. This lets you decide whether to compress the 
files in your volumes to create additional space. Once you enable file 
compression, you cannot turn it off without recreating the volumes. 
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Prevent Access to Deleted Files (Data Shredding) 


The Data Shredding feature overwrites purged disk blocks with random 
patterns of hexidecimal characters. This prevents unauthorized users from 
using a disk editor to access purged files. You can place up to seven data shred 
patterns over deleted data. 


Set Up User Space Restrictions 


User space restrictions let you limit the space users have on volumes. This is 
beneficial for systems that accommodate a large number of users, such as 
students. When you create volumes, you can select the user space restriction 
option in ConsoleOne. 


Set Up Directory Space Restrictions 


Directory space restrictions let you limit the space users can have in a 
directory or subdirectory. 


Use CD-ROMs as Read-only Logical Volumes 


NSS has full CD-ROM support for ISO9660 and Macintosh* HFS formats. 


No Additional Memory Required for Mounting Volumes 


When you mount volumes using the traditional NetWare file system, it scans 
every file and directory during the mounting process. Then it loads all the files 
into memory for quick access. If you increase the number or size of files, you 
need additional memory to maintain the performance level you want. 


NSS does not require large amounts of memory to mount volumes because it 
does not scan the entire file system during the mounting process. After the 
mounting is complete, NSS does not load files into memory until you access 
them. Therefore, no additional memory is required when you add files and 
mount volumes. 
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Redirect Data from Unreliable Blocks (Hot Fix) 


As your file system constantly reads and writes data to disk, some disk storage 
blocks lose their ability to reliably store data. NSS uses Hot Fix to prevent data 
from being written to unreliable blocks. 


Hot Fix™ redirects the original block of data (still in memory) to the Hot Fix 
Redirection Area of the partition where the data can be stored correctly. To 
redirect a block of data, the operating system records the address of the 
defective block. Then the server no longer attempts to store data in that block. 


If you do not enable Hot Fix when you create a partition, then no Hot Fix 
object is created and no data redirection can occur. You need to set up Hot Fix 
when you create the partition. To add Hot Fix later, you must delete the 
volumes from the partition, add Hot Fix, then restore the volumes from a 
backup. 


The Hot Fix feature is combined with partition mirroring. When you select 
Hot Fix, you also enable mirroring for that partition. 


Hot Fix redirection can occur during a write request, a read request, or a read- 
after-write verification. The following are conditions of data redirection: 


+ Write redirection occurs when the disk reports an error during a write 
request. The system marks the block as bad and redirects the data to a 
different block. 


+ Read redirection occurs when a disk error happens during a read request. 


If the disk is mirrored, the system retrieves the data from the mirrored 
disk and redirects the data on the primary disk. If the disk is not mirrored, 
the data is lost, and the block is marked as unusable. 


+ Read-after-write-verify redirection occurs after data is written to disk. 
The data on disk is then read and compared to that in memory. If the two 
don’t match, the system marks the block as bad and redirects the data to 
a different block. 


By default, 2 percent of a disk’s space is set aside as the Hot Fix Redirection 
Area. You can increase or decrease this amount. 


If Hot Fix is enabled, then it is always active unless the disk fails or the 
redirection area is full. You can view Hot Fix activity in MONITOR by 
selecting Storage Devices and then a Hot Fix partition. For information on 
using MONITOR, see MONITOR in the Utilities Reference. 
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You can specify no Hot Fix Redirection Area when you create disk partitions. 
Having no Hot Fix Redirection Area saves partition space. This might be 
useful on large RAID systems that provide a method of fault tolerance. 


IMPORTANT: If Hot Fix is not enabled, then the partition will not have the fault 
tolerance provided by NetWare. Data on corrupted sectors of the disk won't be 
redirected to the Hot Fix Redirection Area. In addition, you cannot mirror partitions 
that do not use Hot Fix. It is easiest to enable Hot Fix when you create the partition. 
To add Hot Fix later, you must delete all the volumes on the partition. 


Repair Storage Pools Instead of Individual Volumes 


You use VREPAIR to fix traditional volumes. For instructions on using 
VREPAIR, see VREPAIR Utilities Reference. For logical volumes, you use 
repair utilities called VERIFY and REBUILD on the storage pools that 
contain the logical volumes. For instructions on rebuilding logical volumes, 
see “Rebuilding NSS Storage Pools and Volumes” on page 48. 


VERIFY checks the file system integrity for an NSS pool by searching for 
inconsistent data blocks or other errors. This utility indicates if there are 
problems with the file system. 


REBUILD verifies and uses the existing leaves of an object tree to rebuild all 
the other trees in the system. You need to deactivate pools (and all the volumes 
in the pools) before you run Rebuild so users cannot access the volumes you 
are rebuilding.When you deactivate a storage pool, all the volumes in the pool 
automatically deactivate. 


These utilities are not the same as VREPAIR. You should use REBUILD only 
as a last resort to recover the file system after data corruption. When you use 
REBUILD and VERIFY, a log file is generated to the root of the DOS drive. 


Mirror Partitions 


You can protect your data by mirroring your partitions. Mirroring stores the 
same data on separate disks using the same controller channel. Using 
ConsoleOne, you can mirror both traditional and NSS partitions. 


The following is a list of requirements for mirroring partitions: 


+ Mirrored partitions must have the same partition type as you mirror the 
partition to. In other words, you can only mirror NSS partitions to other 
NSS partitions—the same applies to traditional partitions. 
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+ You can only mirror partitions. However, you might want to mirror an 
entire storage pool. Because you can have only one storage pool on a 
partition, the only way to mirror that storage pool is to mirror all of the 
partitions the pool resides on. 


+ To mirror partitions, you need to select an option that makes the partitions 
compatible for mirroring when you create them—you cannot change that 
mirroring option after you create a partition. You can mirror to an existing 
group or create a new mirror group for the partition. You cannot combine 
mirror groups (existing groups with multiple mirrored partitions). 


+ Mirrored partitions must have compatible data area size. This means the 
new partition must be at least the same size or slightly larger than the 
other partitions in the group. For example, the physical size (combined 
data and hot fix size) must be at least 100 KB bigger, but no more than 
120 MB bigger than the data size of the existing partitions in the mirror 
group. 


The file system adjusts the Hot Fix size to the legal ranges in order to 
make the data area identical to the other partitions in the mirror group. 


+ Mirrored partitions must have the same sharable for clustering status. 


¢ The partitions you add to a group cannot be part of an existing group— 
they must be individual mirrored objects. 


Stripe Data Across Storage Devices (RAID) 


NSS lets you create an additional storage device by striping data across 
multiple disk drives on your system. This option, called RAID, is a software 
configuration that emulates an actual hardware RAID 0 system. This RAID 
configuration occurs at the software level instead of using a RAID machine. 


You set up a RAID device by obtaining space from all your physical storage 
devices then putting segments on the combined space. A RAID segment is the 
amount of space you obtain from each storage device. You can have up to 
eight segments on a RAID device. The file system places data on the RAID 
disks sequentially. This is called disk striping. The RAID stripe size is the 
amount of data the file system places on a disk before moving to the next disk. 


You can use the software RAID 0 on both logical and traditional volumes. 
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Important Information about NSS RAID 


+ Each element in the RAID configuration should come from a different 
device. NSS will let you obtain RAID elements from the same device, but 
this will severely impede the performance of your file system. 


+ Currently, the NSS RAID supports RAID 0. 
+ The stripe size ranges between 4 KB and 256 KB in increments of 2 KB. 


Features Not Currently Supported by NSS 


The following features are available in the traditional NetWare file system but 
are not currently supported by NSS: 


+ Block suballocation 
+ Auditing 
+ File name locks 


+ Data migration 


NSS Architecture 


With NSS, you can use storage pools, logical volumes, traditional volumes, 
and remote devices to maintain your file system. You store logical volumes in 
storage pools on NSS partitioned space. You store traditional volumes directly 
in space partitioned for traditional volumes. The following diagram illustrates 
the NSS configuration with the available file system options: 
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Figure 1 Novell Storage Services Configuration 
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Setting Up and Configuring Novell 
Storage Services 


Novell® Storage Services™ installs automatically when you install 
NetWare® 6. This section provides instructions for setting up and configuring 
Novell Storage Services (NSS) after the installation. It also contains 
information about configuring and maintaining traditional partitions and 
volumes. 


System Requirements 


U A server running NetWare 6 


Q A least 10 MB free space to create an NSS storage pool and logical 
volume 
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Updating NSS Volumes 


After you upgrade to NetWare® 6 and reboot the server, you need to update 
your NSS volumes. NSS volumes from previous releases will not function 
until you update them to NetWare 6 volumes—they do not upgrade 
automatically. 


Checking the NDS Status 


Before you update NSS volumes, you must ensure that NDS? is running 
properly; otherwise, the upgrade process might remove your trustees. To 
check ensure NDS is running, you need to check the time stamp for the 
backlink process. 


Setting Up and Configuring Novell Storage Services 19 


Do the following to ensure NDS is running: 
1 Use iMonitor to determine that the upgrade process is complete. 


1a Open ¡Monitor in a network browser by entering the IP address of the 
server followed by /nds. For example: http://155.555.1/nds. 


1b Click Agent Process Status > External Reference Status. 


1c Make sure the time stamp (under the Time column) shows a time 
after the time you began the upgrade—specifically when NDS 
unloaded during the upgrade. The following graphic provides and 
example of the time stamp: 





F Server Status: JESLAUGHTER-2000-NDS.novellESLAUGHTER. - Microsoft Internet Explorer 


|| Ble ESL ew Favorites Toos Help | 





|| Heak ++ DD A Ash Ġiraetes Bieta | 5 Sj D 
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NDS” ¡Monitor = Bo), gar 2, 1265 


B .CN=ESLAUGHTER-2000-NDS. O=novell. T=ESLAUGHTER. 
























Novell 








entity: CieAdmin. Osnovell. ESLAUGNTER 





ee External Reference Statu: 
hi Version Flags Time Error Activity Remote Target Target Entry Entry 
id 


Obituary Status 


External Reference Status 08/22/01 Unknown 
Limber Status 08:55:06 (0) 


Known Servers 
Schema 

Agent Configuration 
Trace Configuration 
Agent Health 

Agent Process Status 








If the time stamp shows a time earlier than when you began the 
upgrade, the backlink process is not complete. Repeat Step la 
through Step 1c until the backlink is complete. 
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Upgrading NSS Volumes 


To upgrade NSS volumes, enter one of the following commands at the 
NetWare 6 server console: 


+ NSS /ZLSSVOLUMEUPGRADE=ALL 


€ NSS /ZLSSVOLUMEUPGRADE=volumename 


Transaction Tracking System (TTS) 


Transaction Tracking protects database applications by backing out 
transactions that are incomplete due to a system failure. TTS can be available 
on either all traditional or all NSS logical volumes. It cannot be available on 
all volumes if you use both types of volumes. If your system uses both 
traditional and logical volumes, by default it can only work on traditional 
volumes. If you want to use it on logical volumes on a system that has both, 
you must enter DISABLE TTS on the AUTOEXEC.NCF then enable the 
feature on each logical volume you want it on. Unlike traditional volumes, 
TTS does not apply to logical volumes by default. To enable it on logical 
volumes, enter the following command at the server console: 


nss/transaction=<volname>. 


Setting the Cache Buffers 


A cache buffer is a block (4 Kb) of NetWare server memory (RAM) that 
temporarily stores data. When you install NSS, it consumes 60 percent of the 
the cache buffers by default. 


The following are options for changing the cache buffers: 
+ You can set a maximum of 1048576 cache buffers. 


+ You can set the buffers in percentages rather than integers. 


Use the following commands at the server console to set your cache buffers or 
tune your cache parameters. You can set or tune cache buffers at anytime. 
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Task Purpose Command 





Set number of cache buffers This sets the minimum number of nss/ 
cache buffers allocated for NSS file MinBufferCacheSize= 
system access. The default and value 


minimum number of cache buffers is 
512. The range is 256 to 1048576. 





Look up cache buffers To quickly look up cache buffers, the nss/NumHashBuckets 
cache uses a hashing algorithm that 
maps names to buckets. Sometimes 
multiple names map to the same 
bucket. When this occurs, all names 
must be searched to determine if the 
entry is in the cache. The number of 
entries in the hash table is proportional 
to the amount of free memory available 
when you load NSS. 





Set cache buffers for You can set the minimum number of = nss/ 
traditional file system cache buffers that NSS allocates for MinOSBufferCacheSize 
traditional file system access. To 
accomplish this, NSS returns pages to 
the operating system. This occurs until 
the operating system has enough 
pages, or until NSS reaches the 
minimum number of pages. The 
default is 1024. The range is 1024 to 





1048576. 
Set the cache for file and This sets the number of Name cache nss/NameCacheSize 
directory entries entries. NSS keeps a cache of the file 


and directory names it recently looked 
up. This speeds up opening files and 
path searches. The default is 2111. 
The range is 3 to 65521. 





Set name cache to on or off This sets Name Cache to ON or OFF. nss/ (No) NameCache 
The default is ON. 





Use percentages instead of This sets the buffers to percentages nss/ (No) CacheBalance 
integers for cache balancing rather than integers for dynamic 

balancing of free memory for the buffer 

cache. The default is ON. Use this 

switch with /MinBufferCacheSize. 
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Task 





Purpose Command 





Set the amount of cache 
NSS takes from the 
traditional file system 


This is the percent of cache between nss/ 
NSS and the server. The CacheBalance=value 
CacheBalance percentage determines 

how many cache blocks NSS will take 

from the traditional file system for its 

own cache. A high cache balance 

percentage will impede the 

performance of the traditional file 

system. A low cache balance will 

impede the performance of NSS. We 
recommend that you set the cache 

balance parameter to equal the 

percentage of the total disk space you 
allocate for NSS. However, do not 

exceed 80 percent. You might want to 

initially set the parameter at 50 percent 

and adjust this number as necessary. 

The default is 60 percent. The range is 

from 1 to 99 percent. 





Limit the number of cache 
buffers 


This is the maximum number of cache nss/ 

buffers you want. Every time you doa cacheBalanceMaxBuffer 
cache balance, limit the number of 

cache buffers to this amount. 
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Task Purpose Command 





Show the cache hit ratio at. This is the number of cache hits nss/CacheHit 
the server console divided by the number of attempts to 

get a file cache buffer from the cache. 

Any amount above 90 percent is good. 

This means the system is spending 

less time going to the disk to retrieve 

data. Lower numbers indicate NSS 

needs more memory. If this occurs, 

you might want to set the cache 

balance percentage higher. 


Cache hit is the number of times that 
NSS finds the desired file block in the 
cache buffers. 


Cache miss is the number of times that 
NSS does not find the desired block in 
the cache buffers. 


If you allocate more memory to NSS, 
the cache hit percentage increases. 
You can add more memory by adding 
more physical memory, increasing the 
cache balance, or increasing the 
minimum number of cache buffers for 
NSS. We do not recommend lowering 
the minimum number of OS cache 
buffers. 





Set the number of This parameter specifies the number nss/AuthCacheSize 
Authorization cache entries of cache buffers that will be used to 

speed up authorization requests. If 

many trustees have been set on 

different files and directories, we 

recommend that you increase this 

number. The default is 1024. The 

range is 16 to 50000. 
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Task Purpose Command 





Determine how often NSS This timer lets you determine how nss/CacheBalanceTimer 
rebalances the amount of often (in seconds) NSS will rebalance 
cache it uses the amount of cache it uses according 


to the total amount of memory on the 
server. If you have difficulty loading 
NLMs because of low memory, you 
might want to lower this timer setting. A 
lower setting forces NSS to rebalance 
more often. If your server is stable, you 
might want to increase this timer so 
NSS does not work as hard; this will 
ensure the cache remains balanced. 
NSS checks the total number of cache 
buffers to determine if the 
CacheBalance percentage is met. It 
then adjusts the timer to provide the 
appropriate number of cache buffers. 
The default is 30. The range is 1 to 





3600. 
Set the flush time for This sets the flush time for modified nss/BufferFlushTimer 
modified cache buffers cache buffers in seconds. The default 

is 1 second. The range is 1 to 3600 

seconds. 





Show cache buffer statistics This shows the cache buffer statistics. nss/CacheStats 





Reset cache statistics This command lets you clear the nss/reset 
current statistics and start over. This is 
useful for checking the results of 
changes to the system. 





Using ConsoleOne to Configure Novell Storage Services 


ConsoleOne™ is the primary utility you use to configure and maintain 
partitions, storage pools, and volumes in NSS. To open ConsoleOne and 
access the options you need, complete the following: 


1 Open ConsoleOne. 
2 Open the tree you want to work with. 
3 Right-click on the server object you want. 


4 Click Properties. 
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This opens the ConsoleOne interface where you can access the snap-ins 
for managing NSS. The NSS configuration features are in the Media 
snap-in. 


Setting Up ConsoleOne on a Workstation 


To use ConsoleOne on a client workstation, you need to load ConsoleOne 1.3 
or later. Then you must copy the NSS JAR files from your server to your client 
machine. 


1 Copy these three NSS JAR files to your local LIB directory: 


public\mgmt\consoleone\1.3\lib\nssadmin. jar 
public\mgmt\consoleone\1.3\lib\nsscllib. jar 
public\mgmt \consoleone\1.3\lib\nssjavalib. jar 

Copy these two JAR files to your local RESOURCES directory: 
public\mgmt \consoleone\1.3\resources\nssadminres. jar 


public\mgmt \consoleone\1.3\resources\nsscllibres. jar 


Copy the following JAR file to your local SNAPINS directory: 














public\mgmt \consoleone\1.3\snapins\nssadminreg. jar 


Configuring Disk Space 


To set up the NSS storage and file system, complete the following tasks in the 
given order: 


1. 


Create a RAID device (optional). 
See “Creating a RAID Device” on page 27. 


. Create partitions. 


See “Creating a Partition” on page 29. 


. Mirror partitions. 


See “Creating a Partition” on page 29. 


. Create storage pools. 


See “Creating a Storage Pool” on page 31. 


. Create logical and traditional volumes. 


See “Creating a Logical Volume” on page 32 and “Creating a Traditional 
Volume” on page 37. 
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Creating a RAID Device 


NSS lets you create a RAID 0 device by striping data across multiple drives 
on your system. This RAID configuration occurs at the software level. You 
can use this RAID feature for both logical and traditional volumes. 


Important information about NSS RAID 


+ 
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10 


Each element in the RAID configuration should come from a different 
device. NSS will let you obtain RAID elements from the same device, but 
this will severely impede the performance of your file system. 


Currently, the NSS RAID supports RAID 0. This means there is no disk 
redundancy. If one element in the RAID device malfunctions, the entire 
configuration is unusable. 


NSS RAID can accommodate a maximum of eight segments (amount of 
space used from each device) on a device per RAID 0 logical device. 


The stripe size (amount of data the file system places on one device before 
moving to the next device) ranges between 4 KB and 256 KB in 
increments of 2 KB. 


From ConsoleOne, open the tree you want. 
Right-click on the server object and select Properties. 
Click Media > Raid Devices > New. 


Enter the amount of space you want to obtain from each storage device in 
megabytes. 


Select a segment size. 
Select a stripe size. 
Select a RAID type. 


The RAID type indicates the method of how data is striped across the 
different disks. 


Click Next. 
Select the devices you want to use for the RAID configuration. 


You can select one or more devices, but select only the ones you want to 
use for the RAID configuration. 


Click Finish. 


The file system first creates a virtual device unit, then creates a RAID 
device. 
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Deleting a RAID Device 


When you delete a RAID device, the file system deletes all the partitions and 
volumes from all physical storage devices used in the RAID configuration. 


1 From ConsoleOne, open the tree you want. 

2 Right-click on the server object and select Properties. 
3 Click Media > Raid Devices. 

4 Select the Raid device you want to delete. 

5 Click Delete. 


The file system displays a warning message to ensure you want to delete 
the RAID device. 


6 Click Yes or No. 


Increasing the Size of the RAID Device 


You can increase the size of a RAID device by adding more segments from 
another storage device. You should not place more than one RAID segment on 
a disk; this will severely impede the performance of your file system. 


1 From ConsoleOne, click Media > Raid Devices. 

2 Select the RAID device you want to increase. 

3 Click Increase Size. 

4 Select the device you want to add to the RAID configuration. 
5 Click Finish. 


After you add another physical storage device to your RAID device, you 
must restripe the configuration. This stripes the data to the other device 
you added. 


NOTE: The file system performance might slow down during the restriping 
process. Make sure you add all the physical storage devices you want to the RAID 
device before you click Restripe. 


6 Click Restripe. 


The Restripe option recognizes new devices in your RAID configuration 
and distributes the data across all the devices. 
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Marking a Device as Sharable for Clustering 


Creating a Partition 


Some storage devices exist in a storage area network (SAN). These devices 
can be shared by multiple servers in a cluster. 


IMPORTANT: The system hardware does not specify disk drives to come up 
automatically as sharable for clustering or not sharable for clustering. You must 
manually set different devices according to the configuration of your storage 
system. 


The following is important information about making drives Sharable for 
Clustering: 


+ 
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All portions of an NSS pool must be on a storage device using the 
Sharable for Clustering feature. This means if you have a storage pool that 
spans multiple devices, all these devices must be either sharable for 
clustering or not. 


The Sharable for Clustering option is not available for devices that 
contain the storage pool SYS: or Volume SYS:. 


ConsoleOne does not provide the Sharable for Clustering option for 
devices that contain traditional partitions and volumes. 


When you add partitions to a mirror group, all partitions in that group 
must be either sharable for clustering or not. 


From ConsoleOne, open the tree you want. 
Right-click on the server object and select Properties. 
Click Media > Devices. 

Select a device. 

Select Sharable for Clustering. 

Click OK. 


The first task for setting up NSS is to create partitions on your storage devices 
for the NSS storage pools and logical volumes. 


1 


From ConsoleOne, open the tree you want. 


2 Right-click the server object and select Properties. 


3 
4 


Click Media > Partitions > New. 


Select a device to create a partition on. 
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5 Select the type of partition you want to create (NSS, Traditional, Remote 
Storage Device). 


6 Enter the size of the partition in bytes (B), kilobytes (KB), megabytes 
(MB), or gigibytes (GB). 
7 To reserve space for the Hot Fix error correction feature, select Hot Fix 


and enter the amount of space or percentage you want to reserve. 


Mirrored partitions must be compatible in data area size. This means the 
new partition must be at least the same size or slightly larger than the 
other partitions in the group. The physical size (combined data and Hot 
Fix size) of the partition must be at least 100 KB, but no more than 120 
MB larger than the data size of the existing partitions in the mirror group. 


8 To mirror the partition, select Mirror and select one of the following 
options: 


+ Create New Mirror. This option means you are making the partition 
capable of being part of a mirror group. You do not actually create 
the group until you add another mirrored partition to the partition you 
are creating. 


+ Existing Mirror Group. (If you select this option, also select the ID 
of the mirrored partition.) This shows a list of existing mirror groups 
that are compatible in data area size. This option lets you add this 
new partition to one of the mirror groups in the list. 


9 Select a label for the partition (optional). 
10 Click OK. 


Deleting a Partition 


When you delete a partition you remove all volumes and data on that partition. 
If the partition is mirrored, the other partitions in the mirror group will retain 
the data from the deleted partition. If you want to delete a mirrored partition, 
you must unmirror that partition before you delete it. 
Unmirror a partition 

1 From ConsoleOne, open the tree you want. 

2 Right-click the server object and select Properties. 

3 Click Media > Partitions > Mirror. 

4 Select the partition you plan to delete, click Remove. 


This removes the partition from the mirror group. You can now delete the 
partition. 
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Delete a Partition 


1 


From ConsoleOne, open the tree you want. 


2 Right-click the server object and select Properties. 
3 Click Media > Partitions. 


4 Select the partition you want to delete, click Delete. 


Creating a Storage Pool 


After creating and setting up your partitions, you can create storage pools 
within the partitions. When you create a storage pool, NSS lets you determine 
how much space to use from each storage device on your server. 


When you create storage pools, you use partitioned disk space. However, you 
can select unpartitioned space. This will create a partition and make the 
storage pool the same size of the partition because you can have only one 
partition per storage pool. 


1 


2 
3 
4 
5 


From ConsoleOne, open the tree you want. 
Right-click on the server object and select Properties. 
Click Media > NSS Pools > New. 

Enter a name for the new storage pool and click Next. 


Select the existing NSS partitions or unpartitioned free space that you 
want to use for the pool. 


If you select an unpartitioned device, you can double-click on the number 
in this column to edit the current amount of space you want to obtain from 
the storage devices. The storage pool size will be the total of all devices 
in the pool. 


Enter the size you want from each NSS partitioned space or unpartitioned 
space and click Next. 


You can select any of these options: 


+ Create a Logical Volume with this same name. Automatically 
creates a logical volume when you create the pool. 


+ Sharable for Clustering. Available if Clustering is installed and you 
want to use the feature. 


+ Activate. Activates your pool and any logical volumes when you 
create the pool. Otherwise, you can activate it later. 


Click Finish. 
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Creating a Logical Volume 


After creating storage pools, you can create any number of logical volumes for 
the storage pools according to the physical space available. When you create 
a logical volume, you can either assign it a space or allow it to expand to the 
pool size. 


The size of a single volume cannot exceed the size of a storage pool. However, 
the combined sizes of multiple volumes can exceed the size of the storage 
pool. This is called overbooking. For example, you might have an 800 MB 
storage pool with eight volumes set at 100 MB each. That is the maximum 
amount of space you have in the pool. To overbook the pool, you can add 
volumes or increase the size of existing volumes knowing that not all the 
volumes in the storage pool will fill up. Ifthe volumes fill up, you need to add 
more disk space. 


NSS recognizes DOS, Macintosh*, UNIX*, and long name spaces. 
41 From ConsoleOne, open the tree you want. 

Right-click on the server object and select Properties. 

Click Media > NSS Logical Volumes > New. 


Enter a name for the volume and click Next. 


a A ON 


Select the storage pool where you want to store the unpartitioned space or 
NSS partitioned space. 


If you select unpartitioned space, NSS creates an NSS partition, then the 
storage pool, then the volume. 


6 Do one of the following: 


+ Enter a quota size for the volume if you want to limit the size of the 
volume. 


+ Mark “Allow volume quota to grow to the pool size” if you want the 
volume expand to the size of the pool. 


7 Click Next. 


8 Select the attribute settings you want for the new logical volume from the 
following list: 


+ Backup. Indicates if the volume should be backed up. Set this flag if 
the volume contains data you want to back up. Clear this flag if the 
volume is empty or if backing up the data is unnecessary. This 
backup option is separate from the third-party backup vendor you 
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+ 


+ 


use. This means your backup system might not recognize this option 
whether you select it or not. 


Compression. Activates file compression in the logical volumes. 


Data Shredding. Activates the Data Shredding security feature. This 
feature scrambles any data that you delete to prevent anyone from 
accessing the information with a disk reader. Enter the number of 
times you want the data shredder to scramble your deleted files. You 
can select between one and seven times. 


Directory Quotas. Activates a feature that lets you assign a 
maximum quota of space a directory can have 


Flush Files Immediately. Activates the feature that flushes all data 
in a file to disk immediately when you close the file. 


Modified File List (MFL). This provides a list of all files modified 
since the previous backup. A third-party vendor must implement the 
Modified File List feature in order for you to use it. 


Salvage Files. Activates the feature that lets you salvage deleted 
files. The file system keeps all deleted files in an allocated space until 
that space is needed for other data. The Salvage feature tracks the 
files and lets you retrieve the data for a time until the space is needed 
for other data. You must select this option to salvage the files in the 
volume. 


Snapshot-File Level (File Snapshot). Activates the Snapshot feature 
at the file level. The Snapshot feature allows the backup utility to 
capture a snapshot of the last closed version of a file. For example, if 
your system backs up or crashes while you have a file open, this 
feature will save a copy of the file before you opened it. You might 
lose some new information, but you will retain all the previous 
information. 


User Space Restrictions. Activates the user space restrictions 
feature on the volumes you create. 


Activate. Activates logical volumes as soon as you create them. 


Mount. Mounts logical volumes as soon as you create them. 


9 Click Finish. 


You can now store and manage files in the NSS system. 
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Renaming a Storage Pool 


You can rename existing storage pools. For example, you might want to assign 
a storage pool name that relates to a department name change. 


41 From ConsoleOne, open the tree you want. 

2 Right-click on the server object and select Properties. 
3 Click Media > NSS Pools. 

4 Select a pool to rename. 

5 Click Rename. 

6 Enter a new name for the pool. 


7 Click Finish. 


Renaming a Logical Volume 


You can rename logical volumes. For example, you might want to change the 
name of a volume to reflect the department or organization that uses it. 


4 From ConsoleOne, open the tree you want. 

2 Right-click on the server object and select Properties. 
3 Click Media > Logical Volumes. 

4 Click Rename. 

5 Enter a new name for the logical volume. 


6 Click Finish. 


Increasing the Size of a Storage Pool 


You can increase the size of your storage pools, but you cannot reduce their 
size. 


41 From ConsoleOne, open the tree you want. 

2 Right-click on the server object and select Properties. 

3 Click Media > NSS Pools. 

4 Select the storage pool you want to increase, then click Increase Size. 


5 Select the storage objects you want to obtain the space from. 
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6 Enter the amount of space you want from each storage object in the Used 
column. 


7 Click Finish. 


Deleting NSS Pools or Logical Volumes 


You might need to delete a storage pool or a logical volume to create more free 
space for other storage pools. When you delete a logical volume or a 
traditional volume from a partition, that partition still owns the space, but you 
can reassign the space to another storage pool or traditional file system 
volume. When you delete a partition, ownership of the space in that partition 
is removed. 


After you delete a logical or traditional volume, free space becomes available. 
You can assign this space to other storage pools to increase their size. You can 
also use the free space (if you removed NSS ownership) for a traditional file 
system volume. If necessary, you can restore a volume, see “Reviewing and 

Restoring Deleted Logical Volumes” on page 35. If you delete a storage pool, 
you cannot restore any of the volumes in that pool. 


4 From ConsoleOne, open the tree you want. 
2 Right-click on the server object and select Properties. 
3 Click Media > NSS Pools or Logical Volumes. 


4 Select the pool or volume you want and click Delete. 


Reviewing and Restoring Deleted Logical Volumes 


If you delete a volume, the file system removes it from the storage pool. 
However, for a specified amount of time, called the Purge Delay time, you can 
review and even restore the contents of the volume you deleted. For example, 
you might want to restore information in a volume that was deleted in error. 
You must retrieve the volume before the delay time elapses; otherwise, the 
volume is removed from the system and you can no longer access it. 


If you delete a storage pool, you delete all the volumes in that pool. You cannot 
restore volumes. 


The default setting for the Purge Delay time is two days. After this time 
expires, NSS automatically purges the volume. You can change the Purge 
Delay time to extend or reduce the time for the automatic purging cycle. See 
“Changing the Purge Delay Setting” on page 36. You can also manually purge 
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deleted volumes. You purge or restore volumes in the “Deleted Logical 
Volumes on Pool” screen. 


1 From ConsoleOne, open the tree you want. 
2 Right-click on the server object and select Properties. 
3 Click Media > Logical Volumes. 
4 Click Deleted Volumes. 
5 Select one of the following options: 
+ Purge. Click Purge to immediately purge all the deleted volumes. 


+ Prevent Purge/Allow Purge. Click Prevent Purge to stop the 
volume purging process. For example, you might want to access the 
deleted volume again, or wait until there is less activity on the server. 
After you click Pause Purge, the button changes to Allow Purge. 
Click this button to purge the volume. 


+ Salvage. Click Salvage to restore the deleted volume. 


+ Refresh. Click Refresh to rescan the volumes that have been deleted 
and update the list in the panel. 


6 Click Close when you are finished. 


Changing the Purge Delay Setting 


The default for the Purge Delay setting is two days. This is the amount of time 
that you can still access the volume before it is removed from the system. To 
change the Purge Delay time, enter the following at the server console: 


NSS/logicalVolumePurgeDelay=ddd 


In this command, you replace ddd with the actual number of seconds to delay 
the auto purge. The default is 172800 (2 days). For example, if you want to 
change the Purge Delay time for one day, enter 86400. 


The Purge Delay change command is not permanent. You must enter the 
command each time you restart the server. If you want to make the new setting 
permanent, enter the command in the AUTOEXEC.NCF file. 
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Creating a Traditional Volume 


NSS is the default file storage and management system in NetWare 6. 
However, you might want to continue maintaining traditional partitions and 
volumes in NSS. The following is a list of guidelines for creating traditional 
volumes in NetWare 6: 


+ NWCONFIG and NSS Menu are not compatible with NetWare 6. Use 
ConsoleOne to create, mount, modify, and rename traditional volumes. 


+ You can use VREPAIR to fix traditional volumes, but you need to use 
VERIFY and REBUILD for all logical volumes. For instructions on using 
VREPAIR, see VREPAIR in the Utilities Reference. 


+ You cannot put traditional volumes in an NSS storage pool. 


+ If you create a traditional volume in NetWare 6, you cannot access that 
volume from previous releases of NetWare. 


You can use ConsoleOne to create, mount, and manage traditional volumes. 
1 From ConsoleOne, open the tree you want. 
2 Right-click on the server object and select Properties. 

Click Media > Traditional Volumes. 

Click New. 

Enter a name for the volume and click Next. 

Select either partitioned or unpartitioned. 

Enter a size for the volume in the Used column and click Next. 


Select a block size from the pull-down menu. 
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Select any of the following options: 


+ Compression. Enables the file system to compress the files in the 
volume. You set up file compression when you create volumes. Once 
you enable file compression, you cannot turn it off without creating 
the volume again. 


+ Migration. Enables the operating system to move infrequently 
accessed data to remote areas on your server. This creates space for 
new and more commonly accessed data. Selecting this option only 
enables the attribute. The data migration feature uses a third-party 
software package that does the migration function. 
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+ Suballocation. Enables the file system to divide partially used disk 
blocks into suballocation blocks of 512 bytes. These blocks can be 
used by other data files. 


+ Mount Volume on Creation. Instructs the operating system to 
mount the volume when you create it. Otherwise, you can mount it 
later. 


10 Click Finish. 


Increasing the Size of a Traditional Volume 


To increase the size of a traditional volume, you need to add another segment 
to that volume. 


1 From ConsoleOne, open the tree you want. 

Right-click on the server object and select Properties. 

Click Media > Traditional Volumes. 

Select a volume and click Increase size. 

Select the storage device you want to obtain space from. 
Double-click on the Used column next to the selected storage device. 
Enter the amount of space you want. 


Click Finish. 
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Renaming a Traditional Volume 


You can rename a traditional volume. 
1 From ConsoleOne, open the tree you want. 
2 Right-click on the server object and select Properties. 
3 Click Media > Traditional Volumes. 
4 Select the volume you want to rename and click Rename. 
5 Enter a name. 


6 Click Finish. 
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Deleting a Traditional Volume 


You can delete traditional volumes. 
1 From ConsoleOne, open the tree you want. 
2 Right-click on the server object and select Properties. 
3 Click Media > Traditional Volumes. 


4 Select the volume you want to delete and click Delete. 


Dismounting a Traditional Volume 


To repair a traditional volume, you need to dismount that volume. 
1 From ConsoleOne, open the tree you want. 
2 Right-click on the server object and select Properties. 
3 Click Media > Traditional Volumes. 
4 Select the volume you want to dismount and click Dismount. 


The button label changes to mount. 


Repairing a Traditional Volume 


Typically, you can't mount a volume if it has even minor damage. 
Occasionally, a damaged volume mounts and causes errors in the process. 


Use VREPAIR to correct volume problems or to remove name space entries 
from File Allocation Tables (FATs) and Directory Entry Tables (DETs). For 
instructions on using VREPAIR, see VREPAIR in the Utilities Reference. 


NOTE: If you need to repair an NSS volume, see “Rebuilding NSS Storage Pools 
and Volumes” on page 48. 


You can run VREPAIR on a damaged volume while other volumes are 
mounted. Following are typical instances when VREPAIR can help: 


+ A hardware failure either prevented a volume from mounting or caused a 
disk read error. 


NOTE: Although VREPAIR can't fix hardware problems, VREPAIR can sometimes 
fix related volume damage. 


+ A power failure caused a corrupted volume. 
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+ The server console displays a mirroring error when the server boots. This 
mirroring refers to the two copies of FATs and DETs that the operating 
system keeps (if disks are mirrored, NetWare keeps four copies). 


If a volume fails to mount as the server is booting, VREPAIR loads 
automatically and attempts to repair the volume. 


When VREPAIR autoloads, it uses the default options. If you want to use an 
alternate option, load VREPAIR manually and set the alternate option before 
running VREPAIR. 


NOTE: If you don't want VREPAIR to automatically repair a volume that won't 
mount, use the SET parameter named Automatically Repair Bad Volumes to 
change the default. 

Prerequisites 


U The volume you want to repair must be dismounted. 


U If the volume to be repaired has name space support, the corresponding 
VREPAIR name space module (V_namespace.NLM) must be located in 
either the SYS:SYSTEM directory or in a search path directory. 


Example modules include V MAC.NLM and V_LONG.NLM. 


Procedure 
4 At the server console prompt, enter 
VREPAIR [volume_name] [logfile_name] 


(Optional) Replace volume name with the name of the volume to repair. 
If there is only one volume that is dismounted, you don't need to specify 
this parameter, since VREPAIR will attempt to repair that volume. 


(Optional) If you want to save the error log, replace the logfile_name with 
the name of the file you want VREPAIR to create. VREPAIR creates a log 
of errors it finds. VREPAIR displays the errors on screen and will write 
them to a file if you specify a filename. 


When you load VREPAIR, an Options menu is displayed. 
2 Accept the default options, or select alternate options, as appropriate. 


The first time you try to repair a volume, accept the default options. If the 
default options fail to repair the volume, select alternate options. 


2a To accept the default options, continue with Step 3. 
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2b To set alternate options at the Options menu, choose Set VRepair 
Options by typing 


2 Enter 


To begin the repair process, choose Repair A Volume from the Options 
menu. 


+  Ifmore than one volume is dismounted, select the volume to repair 
from those listed. 


+  Ifonly one volume is dismounted, VREPAIR assumes it is the 
volume that needs repairing and begins the repair. 


As the volume is being repaired, the server console screen displays a 
message indicating VREPAIR activity. 


(Optional) Modify error log settings after the repair has started. 


If VREPAIR finds many errors during the repair process, you might want 
to change some of the run-time error settings. To modify these settings 
after the repair has started, press F1 to display the Current Error Settings 
menu. 


+ Select Option 1 if you do not want VREPAIR to pause after each 
error. 


+ Select Option 2 if you want VREPAIR to log errors in a text file. 
+ Select Option 3 to stop the repair of the volume. 


+ Select Option 4 to continue with a volume repair after you have 
stopped it. 


When the repair is complete, answer Y when prompted to write repairs to 
the disk. 


If VREPAIR has found errors, run VREPAIR again by repeating Step 2 
through Step 6. Repeat until VREPAIR finds no errors. 


If you are unable to mount the volume after running VREPAIR several 
times, you must delete the volume, re-create the volume using 
ConsoleOne. 
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Setting Up File Snapshot 


The File Snapshot feature enables your backup utility to keep an original copy 
of all data files. For example, when your system backs up or crashes at a time 
when you are modifying a file, the file backup could contain both old and new 
data. Snapshot captures the most recent closed copy of the file. This way, if 
you lose data between the backup cycles, you still have a solid copy of the 
previously saved file. 


If you select File Snapshot on a volume, the backup utility copies all the meta- 
data (owner, created date/time, modifier, etc.). During write requests, only the 
data that is being written to is copied. NSS recognizes how to return the 
appropriate data when read requests come in for the real file or the Snapshot 
file. 


Use the following NSS command at the server console to enable the File 
Snapshot for a volume: 


nss/FileCopyOnWrite=<volName> 
or 

nss/FileCopyOnWrite=all 

To disable File Snapshot, enter the following: 
nss/NoFileCopyOnWrite 


After you set up File Snapshot on your volumes, you need to deactivate the 
volumes. Then you need to activate and mount the volumes again to ensure 
there are no open files without a snapshot. 


To open a snapshot file for backup, you need to set a bit in the requested rights 
parameter in addition to READ ACCESS BIT. This bit is 0x04000000. It is 
defined in the NSS header files as zPR_ READ ACCESS TO SNAPSHOT. 
The default setting for File Snapshot is when your file system receives an open 
for write request, it will wait for the backup open to close the file. If you want 
to return an error, the backup open should also set the deny the write bit. 


To get information on a snapshot file, use the getInfo command. Any getInfo 
call that returns packed information with the RNewStyle bit set in the info 
mask is supported. You need to set an additional bit 0x20000000 in the 
information mask. This bit is defined at RNSSInfoOnSnapshot in NSS header 
files. Both open and getinfo calls require the bit for requested rights and the 
bit for additional info mask. 
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The following are some additional calls that return information about File 
Snapshot: 


+ GetFileSize 
+ GetFileHoles 


You can also use ConsoleOne to select the File Snapshot feature. See 
“Creating a Logical Volume” on page 32. 


Converting Traditional Volumes to Logical Volumes 


You can convert traditional volumes to logical volumes. This is not an 
automatic process or an in-place upgrade. You need to ensure you have 
enough space to transition from a traditional volume to a logical volume and 
maintain your attributes. The conversion utility is a server command that 
copies the data from a traditional volume to an NSS logical volume inan NSS 
storage pool. (For example, if you want to move a 2 GB volume, you need to 
have at least 2 GB of free space available. The original volume will be 
renamed volumename_old. The new logical volume will keep the original 
volume name. 


Volume Conversion 


After you copy the traditional volume to a logical volume, you can restart the 
server to ensure the volume converted properly. If the volume converted, you 
can remove the traditional volume. After you copy traditional volume data to 
a logical volume in NetWare 6, you cannot access the new logical volume in 
NetWare 5.1. You would need to either retain the data in the traditional 
volume, or copy the data back to the traditional volume. 


The volume conversion utility can convert volumes with long names. 


The following is a sample command line with all the available parameters for 
converting traditional volumes: 


veu /p /1 /1 /d /r original Volume nssPool [ds_container [ds_volName]] 
+ /p: Do not print directory file names. 
+ /1: Do not write errors to log file (Dst Vol:error.out). 


+ /i:Keep file COMPRESS FILE IMMEDIATELY BIT. 
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+ /d: Delete original volume if copy process is successful. If you choose to 
delete the traditional volume, the new volume will retain the name of the 
that volume. 


+ /r: Remove xxx_new NSS volume and restore xxx traditional volume (use 
this option if you want to keep the original volume name for the new 
logical volume name). 


¢ ds container: Original volume’ DS container 


+ ds volumeName: If specified, the vcu conversion utility uses this name 
to rename or delete the original volume’s DS object. Otherwise, vcu.nlm 
uses serverame_originalVolName as the default DS name 


The parameters in this list are optional; you can include any of the parameters 
in the list. 


To convert a volume, you specify the volume to convert and then specify the 
NSS pool where you want to store the data from the volume. Enter the 
following at the server console: 


vcu volume_name pool_name 
For example, 
vcu apps poolone 


In this example, the volume conversion utility copies the data in the volume 
apps and places it in Poolone. 


If you want to keep the name of the traditional volume and use it for the new 
logical volume, enter the following at the server console: 


vcu /r xxxx yyyy_old[ds_container[ds_volName] ] 


In this example, xxxx is the original traditional volume name, yyyy_old is the 
modified traditional volume name. If xxxx is longer than 11 characters, 
yyyy_old might be VCU0000_ old, otherwise pppv old will be xxxx_old. 
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Modifying NDS Objects 


The volume conversion utility lets you modify the NDS objects and physical 
names for both logical and traditional volumes except the VOL SYS. Use the 
following commands VCU commands if you want to change the NDS objects 
with the volume conversion process. 


Volume copy 


vcu VCUTargetVolName NSSPoolName (DS container 
DS NSSPool name DS volnamej 


Volume restore 


vcu /r VCUTargetVolName VCUTargetVOlName old (DS container 
DS NSSPool name DS Volname 


Setting Up User Space Restrictions 


You can limit the amount of space users can have on a volume. This is 
beneficial for svstems that accommodate a large number of users, such as 
students. You might need to regulate the amount of space each user can have. 


When you create volumes, you can select the user space restrictions option. 
1 From ConsoleOne, open the tree you want. 
2 Right-click the server object and select Properties. 
Right-click on the volume that contains the user object you want. 
Click Properties > Attributes > NSS Attributes. 
Select User Space Restrictions. 


Click Users with Space Restrictions. 


NO GF A O 


Select the user you want to apply restrictions to. 

If the user you want is not in the list, do the following: 
Ta Click Add. 

7b Browse for the user you want. 

7c Double-click on the user. 


The User Space Restriction dialog box opens. You can enter or 
modify the User Space Restriction parameters in this box. 
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8 Click Modify. 


9 Enter or edit the user space amount in the Limit field and click OK. 


Setting Up Directory Space Restrictions 
You can limit the amount of space occupied by a directory and the files it 
contains. 
1 Open ConsoleOne. 
2 Right-click on the directory you want. 
3 Click Properties and then Facts. 
4 Select Restrict Size. 
5 Enter the amount you want to limit the size to and click Apply. 


6 Click Close. 


Mounting a Logical Volume 


After you set up and configure logical volumes, you can mount them. 
1 From ConsoleOne, open the tree you want. 
2 Right-click the server object and select Properties. 
3 Click Media > NSS Logical Volumes. 


4 Choose the logical volume you want to mount and click Mount. 


Deactivating/Activating NSS Pools and Volumes 


You might need to temporarily restrict user access to a storage pool or volume. 
Instead of bringing down the server, you only need to deactivate the specific 
volume or pool. You can deactivate both storage pools and volumes; however, 
you can only do maintenance (rebuild and verify) on storage pools. This 
means that users will be unable to access any of the volumes in the pool while 
you run REBUILD and VERIFY. When you use REBUILD and VERIFY a 
log file is generated to the root of the DOS drive. For instructions on running 
REBUILD and VERIFY, see “Rebuilding NSS Storage Pools and Volumes” 
on page 48. 


1 From ConsoleOne, open the tree you want. 
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2 Right-click on the server object and select Properties. 

3 Click Media > NSS Pools or Logical Volumes. 

4 Select the storage pool or volume you want to activate or deactivate. 
5 Click Activate or Deactivate. 


6 Click Activate when you are ready to restore access to the volume or pool. 


Salvaging and Purging Deleted Files 


You can salvage files that were deleted by users, or purge deleted files to 
improve your file system performance. Deleted files are ina DELETED.SAV 
directory in the volume’s root directory. 


1 In ConsoleOne, open the tree you want. 
2 Select the volume that contains the deleted file. 
3 Click View > Deleted File View. 


The Deleted File section lists the deleted file, the file size, the deletion 
date, and the user’s name. 


4 Select the file you want to Salvage or Purge. 


5 Click Salvage or Purge on the ConsoleOne Toolbar. 


Using NetWare Backup Services 


You can use the backup services provided with NetWare (Backup and Restore 
Services) to back up your NSS data. For instructions for using Backup and 
Restore services, see the Storage Management Services Administration 
section in the Storage Management Services Administration Guide. 


IMPORTANT: Be sure to use the version of the Target Service Agent (TSA600). 
Earlier versions do not work with NSS. 
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Rebuilding NSS Storage Pools and Volumes 


To repair storage pools and logical volumes, NSS uses the VERIFY and 
REBUILD utilities. 


VERIFY checks the file system integrity for an NSS pool by searching for 
inconsistent data blocks or other errors. This utility indicates if there are 
problems with the file system. 


REBUILD verifies and uses the existing leaves of an object tree to rebuild all 
the other trees in the system. You need to deactivate pools (and all the volumes 
in the pools) before you run REBUILD so users cannot access the volumes 
you are rebuilding.When you deactivate a storage pool, all the volumes in the 
pool automatically deactivate. 


REBUILD also copies errors and transactions into an error file called 
volume_name.rlf at the root of the DOS drive on your server. Every time you 
rebuild a particular NSS volume, the previous error file is overwritten. If you 
want to keep old error files, move them to another location. You can check the 
error file whenever an NSS volume does not come up in active mode after a 
rebuild. 


REBUILD is not equivalent to VREPAIR. You should use REBUILD only as 
a last resort to recover the file system. If you use it to recover from data 
corruption, you will likely lose some data in the process. 


When you use REBUILD and VERIFY a log file is generated to the root of 
the DOS drive. 


1 Torun rebuild, enter the following command at the server console: 
nss/poolrebuild=<poolname> 


This verifies and accounts for all blocks in the system. If the volume has 
errors, the errors appear on the screen. The NSS volume remains in 
maintenance mode; otherwise, it reverts to the active state. You then need 
to mount the volume again. 


You can also verify a pool by enteringnss /verify for a list of pool 
names, and then selecting the pool. Verify is a read-only assessment of the 
pool. 
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NSS Server Console Commands 


Use the following commands at the server console to view NSS information 
and perform tasks. 


Online Help Commands 


Enternss /helpornss /? toaccess Help. 


NSS Configuration Information Commands 


+ 


+ 


nss /modules Lists the providers, loadable storage subsystems, and 
semantic agents. 


nss /status Lists the current NSS status. 


volumes Lists all NetWare and NSS volumes that are mounted, 
including Admin volume. 


nss volumes Lists all NSS volumes, including the Admin volume. 


Other NSS Commands 


+ 


+ 


+ 


+ 


nss /Activate=volume_name Activates an NSS volume. 
nss /Deactivate=volume_name Deactivates an NSS volume. 


nss /Maintenance=volume_name Switches the specified NSS 
volume to maintenance mode. 


nss /ForceActivate=volume_name Forces an NSS volume to 
become active. 


nss /StorageAlarmThreshold=value Lets you set the threshold 
for a low storage space warning. The default is 10. The range is 0 to 
1000000. 


nss /StorageResetThreshold=value Lets you reset the 
threshold for a low storage space warning. The default is 10. The range is 
1 to 1000000. 


nss / (No) StorageAlertMessages Tums ON or OFF the low 
storage message to users. The default is ON. 


nss /NumWorkToDo=value Sets the number of WorkToDo entries 
which may be concurrently executing. NSS uses WorkToDo entries for 
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tasks such as flushing file metadata to disk in the background. Increasing 
the number of WorkToDo entries might be useful on a system that is 
heavily used. NSS always reserves 20 WorkToDo entries. The default is 
40. The range is 5 to 100. 


+ 


nss /FileFlushTimer=value Sets the flush time for modified open 
files in seconds. Increasing this number might reduce the number of 
writes to disk; however, it increases the amount of data that will be lost if 
the system crashes. The default is 10 seconds. The range is 1 to 3600 
seconds. 


* nss /OpenFileHashShift=value Sets the size of the Open File 
hash table (in powers of 2). If many files are used concurrently on the 
server, we recommend that you increase this number. The default is 11. 
The range is 8 to 20. 


€ nss /ClosedFileHashShift=value Sets the number of closed 
files that can be cached in memory. The default is 512. The range is 1 to 
100000. 


* nss /MailBoxSize=value Sets the size of your mailbox. The default 
1s 228. The range is 64 to 256. 


* nss /NumAsyncios=value Sets the number of asynchios entries to 
allocate. The default is 2048. The range is 4 - 65536. 


+ Numbonds=value Sets the number of bond entries to allocate. The 
default is 5000. The Range is 512 - 2097152. 


* Salvage Enable salvage of deleted files on volumes. 
* NoSalvage Disable salvage of deleted files on volumes. 


€ UserSpaceRestrictions Enable user space restrictions on the 
volume. 


€ NoUserSpaceRestrictions Disable user space restrictions on the 
volume. 


* DirectoryQuotas Enable directory quotas on the volume. 
* NoDirectoryQuotas Disable directory quotas on the volume. 


* DataShredding Specify <vol name> [:<count>]. Enables data 
shredding for the volume. This is the number of times you want to shred 
data. The default value is 1. The maximum value is 7. 


* NoDataShredding Disable data shredding on the volume. 
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FlushFilesImmediately Synchronously flush files in the volume 
when they are closed. 


NoFlushFilesImmediately Disable synchronously flushing files 
in the volume. 


FileCopyOnWrite Create a copy of files in the volume when they are 
open for write. 


NoFileCopyOnWrite Do not create a copy of files on the volume 
when they are open for write. 


UpgradeObjectsOnVolume Upgrade objects on volumes to the 
current version. 


Transaction= Enable transactional writes in files on the volumes. 


NoTransaction= Disable transactional writes in files on the 
volumes. 


Migration= Enable migration of files on the volumes. 
NoMigration= Disable migration of files on the volumes. 


AllocAheadBlks=value Set the number of blocks to allocate ahead 
on writes. The default is 15. The range is 0 - 63. 


Compression Enable file compression on the volume. 
NoCompression=volume Disable file compression on the volume. 


NoBGCompession Start or stop background compression. Stop 
BGCompression will stop all the compression requests in the queue. 


CompScreen Start the NSS compression statistics screen. 
Pools Shows all of the currently available NSS pools. 
PoolAutoActivate Activates specified pools at load time. 


PoolAutoDeactivate=pool Leaves specified pools deactivated at 
pool load time. 


PoolAutoDisplay Displays current pool load time policies. 


PoolAutoMaintenance=pool Places specified pools in 
maintenance mode at pool load time. 


PoolAutoVerify Verifies the specified pool’s physical integrity at 
startup time. 


PoolRebuild=pool Rebuild specified pools. 
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€ PoolRebuild Select pools from a menu and rebuild them. 
* PoolVerify=pool Verify the specified pool’s physical integrity. 


* Poolverify Select pools from a menu and verify their physical 
integrity. 


* LogicalVolumePurgeDelayAfterLoad The number of seconds 
to delay purging deleted logical volumes. This allows time to reverse the 
deletion. 


* LogicalVolumePurgeDelayAfterContinue The number of 
seconds to delay purging a logical volume after clicking continue. After 
a volume starts to purge, it cannot be salvaged. 


€ VolumeMaintenance Places a volume into a maintenance mode. 
Volumes can be put in maintenance mode, but maintenance only occurs 
at the storage pool level. 


+ MFL-volume Enables MFL maintenance for the volumes. 
+ NoMFL=volume Disable MFL maintenance for the volumes. 


+ MFLVerify=volume Get the status of MFL maintenance for the 
volumes. 


€ FixMFL MFL maintenance for the volumes. 

+ GetMFLStatus Get the status of MFL maintenance for the volumes. 
* VolumeAutoActivate Activates volume at load time. 

* VolumeAutoDeactivate Deactivates volume at load time. 

* VolumeAutoDisplay Displays current volume load time policies. 
€ ZLSSIOStatus Displays current NSS IO status information. 


€ ZLSSPendingWriteIOs Number of write IOs dropped to the storage 
subsystem. (0 = all available) [Value=1000 Range=0 - 3000]. 


€ ZLSSVolumeUpgrade Allow the 5.x/ZLSS VolumeUpgrade to the 
NetWare 6 format to occur during the installation process. 


¢ LVDeleteStatusBasic Displays information about deleted logical 
volumes. 


* LVDeleteStatusSalvagable Displays information about 
salvagable logical volumes. 


€ ZLSSPoolScan Scans for and loads all ZLSS pools. 
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DOS FAT Commands 


€ nss / (No) FATLongNames Enables long filenames on FAT volumes. 
The default is ON. 


nss / (No) FATLazyWrites Performs lazy writes of FAT. If set to 
ON, data that is written will be kept in memory for a specified period of 
time before it is also written to FAT. This increases performance. The 
default is ON. 


+ 


* nss /FATLazyWriteDelay=value Sets the FAT lazy write delay (in 
seconds). When (No)FATLazyWrites is set to ON, you specify how many 
seconds you want data kept in memory before it is written to FAT. The 
default is 60. The range is 5-180. 


* nss /FATPartitionzpartition tvpe number Supports up to three 
additional partition types containing 16-bit FATs, such as / 
FATPartition=12,13. 


* nss /space Shows the amount of space on pools and their associated 
volumes. 


* NoClassicDirectoryQuotas Turns emulation of traditional 
NetWare volumes on or off. The default is off. 


Other Volumes That NSS Creates 


There are three Loadable Storage Subsystems (LSS) modules: ZLSS.NSS, 
CDHFS.NSS, CD9660.NSS, and DOSFAT.NSS. The ZLSS module provides 
access to logical volumes created by the user. The CD9660 module allows 
access to CD ROM drives as NSS volumes. The DOS FAT module allows 
access to FAT 16 and FAT 12 drives. 


CD-ROMs As Logical Volumes 


When NSS recognizes a CD ROM, it creates a Read-only logical volume for 
that CD ROM. This is done automatically when you load the CDROM.NLM. 
However, this volume is not added to NDS. 


The new CDROM.NLM loads the CD9660.NSS and CDHFS.NSS modules. 
The CD9660.NSS module loads the ISO966, CDHFS, and Macintosh 
Hierarchical File System (HFS) file formats. Dual formatted CDs are mounted 
as two separate volumes. This means both Macintosh and Windows clients 
will see the same CD ROM volumes with two different layouts. 
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The CD9660.NSS module makes the contents of the standard ISO9660 
CDROM available as a Read-Only logical volume. If the CDROM is in the 
drive when CD9660 loads, it will mount as a logical volume immediately. 


The volume name displayed by the NetWare volumes command is the CD- 
ROM volume label if one exists. Otherwise, NSS generates a volume name in 
this form: CDXXXXXX (where X is a number). This volume functions the 
same as any other NetWare volume, except that it is Read-Only. 


To load both the CD9660 and CDHFS modules, enter the following at the 
server console: 


load cd-rom.nlm 

To load CD9660.NSS alone, enter the following at the server console: 
load cd9660.nss 

To load CDHFS.NSS alone, enter the following at the server console: 
load cdhfs.nss 

To unload CD9660.NSS, enter the following at the server console: 
unload cd9660.nss 

To unload CDHFS.NSS, enter the following at the server console: 
unload cdhfs.nss 


The CD ROM unload process dismounts the volumes. 


DOS Partitions As Logical Volumes 


After you load the DOSFAT.NSS module, any DOS FAT partitions are 
dynamically made available as logical volumes. The volume name displayed 
by the NetWare volumes command is DOSFAT_X, where X is the drive 
letter, for example DOSFAT_C. 


The following are some benefits of the DOSFAT.NSS module: 


+ Long filenames (such as DOS filenames for file systems such as OS/2). 
This uses the Windows* 95/98 method for placing long names onto a 
DOS FAT partition. 


+ NetWare trustee rights. Only users with supervisor rights can access the 
volume. 
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+ NetWare utilities. Any client or server utility that accesses or manages 
NetWare volumes can do the same with DOS FAT partitions. 


+ MAP command. NetWare clients can map to the volume and use it as any 
other NetWare mapping. 


+ Local partition. Allows access to the local partition. 
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Viewing Storage Objects 


We recommend that you monitor the status of your storage objects and 
Novell® Storage Services™ configuration to ensure they work properly and 
have available disk space. 


Viewing Storage Devices 
You can use ConsoleOne™ to view your storage devices and see which ones 
have free space. 
1 From ConsoleOne, open the tree you want. 
2 Right-click on the server object and select Properties. 
3 Click Media > Show Devices. 
The left panel lists all the storage devices on your server. 
4 Select the device you want. 


For information about the Devices screen, click Help. 


Viewing Your NSS Configuration 
Occasionally, you might need to review the status of your NSS system storage 


devices or storage space. This section explains how to use ConsoleOne to 
view the status and usage of your storage devices, storage pools, and volumes. 


View Partitioned Free Space 


You can view the free space on all NSS and traditional partitions. Partitioned 
free space is space within an NSS partition that is not occupied by a storage 


Viewing Storage Objects 57 


pool. On a traditional partition, space that is not occupied by a NetWare® 
volume is free space. 


1 From ConsoleOne, open the tree you want. 
2 Right-click on the server object and select Properties. 
3 Click Media > Free Space. 
The left panel lists the storage devices that have free space. 
4 Select the device you want. 


For information about the Free Space screen, click Help. 


Any time the Devices button appears, you can click it to open the Devices 
screen. 


View the Status of Partitions 


You can view the status of both NSS and traditional partitions. For example, 
you might want to see what space is available on either type of partition. 


4 From ConsoleOne, open the tree you want. 
2 Right-click on the server object and select Properties. 
3 Click Media > Partitions. 
4 Select the partition you want. 
The left panel lists both the NSS and traditional partitions. 


For information about the Partitions screen, click Help. 


View the Status of Your Traditional Volumes 


You can view the status of traditional volumes. For example, you might want 
to look at the size of a particular volume, or see the creation and modification 
dates. 


1 From ConsoleOne, open the tree you want. 
2 Right-click on the server object and select Properties. 
3 Click Media > Traditional Volumes. 
The left panel lists all the traditional volumes set up on your server. 
4 Select the volume you want. 


For information about the Traditional volumes screen, click Help. 
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View the Status of Your NSS Storage Pools 


You can view the status of NSS storage pools. For example, you might want 
to see what volumes are in a particular storage pool, or how much space is in 
all your storage pools. 


4 From ConsoleOne, open the tree you want. 
2 Right-click on the server object and select Properties. 
3 Click Media > NSS Pools. 
The left panel lists the NSS storage pools. 
4 Select a storage pool. 


For information about the NSS Pools screen, click Help. 


When the Show Pool button appears, you can click it to open the NSS Pools 
screen. 


View the Status of Logical Volumes 


You can view the status of logical volumes. For example, you might want to 
see if the volume has a space quota. You might also want to see what space is 
available on a volume. 


1 From ConsoleOne, open the tree you want. 
2 Right-click on the server object and select Properties. 
3 Click Media > NSS Logical Volumes. 
The left panel lists both the storage pools and the logical volumes. 
4 Select a volume. 


For information about the NSS Logical Volumes screen, click Help. 
Any time the Show Volume button appears, you can click 1t to see the status 
of the volume you selected. 

View the Quota and Space Usage for Specific Volumes 


You can open a screen that shows the status of a specific volume that has a 
space quota. You can also view the status of the storage pool that volume is in. 


4 From ConsoleOne, open the tree you want. 


2 Right-click on the server object and select Properties. 
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3 Click Media > Logical Volumes. 
4 Click Properties. 
5 Click Statistics > NSS Quota Usage. 


This screen shows the volume’s quota, amount of spaced used, and the 
remaining space. The screen also shows the amount of space used and the 
available space on the storage pool. 


For information about the NSS Quota Usage screen, click Help. 


View and Modify Logical Volume Attributes 


You can view and modify the attribute settings for specific volumes. These 

attributes include data compression, data shredding, directory and user space 
restrictions, and snapshot. For example, you might want to apply some of the 
features that were not included during the initial configuration of the volume. 


41 From ConsoleOne, open the tree you want. 
2 Right-click on the server properties and select Properties. 


3 Click Media > Logical Volumes > Properties > Attributes > NSS 
Attributes. 


4 Make any attribute changes you want. 


For information about the NSS attributes screen, click Help. 
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Troubleshooting 


The following table describes some problems you might experience with 
Novell® Storage Services™ (NSS) and provides suggestions for solving the 


problems. 


For additional troubleshooting information, see the Novell Knowledgebase at 
(www.support.novell.com). 


Problem 


Explanation 





Solution 





NSS does not recognize a 
Device 


NSS recognizes only what the 
Media Manager recognizes. 


For this release, NSS recognizes 
only hard drives and CD ROMs. 





NSS does not let you create a 
storage pool or logical volume 


+ Your server might not have 
enough free space to 
create more storage pools 
or logical volumes. 


e. Alllogical volumes must be 
part of a storage pool. 


+ NSS might not own the 
free space you want to use 
for a storage pool. 


+ Ensure you have enough 
free space to create 
another storage pool or 
logical volume. See “View 
Partitioned Free Space” on 
page 57. 


+ Before you create a logical 
volume, create a storage 
pool. 


+ Create an NSS partition for 
your storage pools and 
logical volumes. 





Cannot configure a logical 
volume 


NSS might not own enough free 


space for another logical volume. 


+ Add another storage 
device. 


+ Delete a logical or 
traditional volume to free 
up space for a storage 
pool. 
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Problem Explanation 


Cannot compress a file You must choose the file 
compression option when you 
create a logical volume. 


Solution 


Apply the file compression option 
to an existing logical volume: 


From ConsoleOne, click Media > 
NSS Logical Volumes > 
Properties > Attributes > NSS 
Attributes. Then select 
compression. 
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